home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 46 / Amiga Format CD46 (1999-10-20)(Future Publishing)(GB)[!][issue 1999-12].iso / -in_the_mag- / reader_requests / scilab / man / man-part1 / cat3 / syslin.3 < prev    next >
Text File  |  1999-09-16  |  2KB  |  133 lines
  1.  
  2.  
  3.  
  4. syslin(1)                      Scilab Function                      syslin(1)
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11. NAME
  12.   syslin - linear system definition
  13.  
  14. CALLING SEQUENCE
  15.   [sl]=syslin(dom,A,B,C [,D [,x0] ])
  16.   [sl]=syslin(A,B,C [,D [,x0] ])
  17.   [sl]=syslin(dom,N,D)
  18.   [sl]=syslin(dom,H)
  19.  
  20. PARAMETERS
  21.  
  22.   dom       : character string ('c', 'd'), or [] or a scalar.  (If omitted,
  23.             dom=[])
  24.  
  25.   A,B,C,D   : matrices of the state-space representation (D optional with
  26.             default value zero matrix). For improper systems D is a polyno-
  27.             mial matrix.
  28.  
  29.   x0        : vector (initial state; default value is 0)
  30.  
  31.   N, D      : polynomial matrices
  32.  
  33.   H         : rational matrix
  34.  
  35.   sl        : list ("syslin" list) representing the linear system
  36.  
  37. DESCRIPTION
  38.   syslin  defines a linear system as a list and checks consistency of data.
  39.  
  40.   dom specifies the time domain of the system and can have the following
  41.   values:
  42.  
  43.   dom='c' for a continuous time system, dom='d' for a discrete time system, n
  44.   for a sampled system with sampling period n (in seconds).
  45.  
  46.   dom=[] if the time domain is undefined (dom can be omitted in the calling
  47.   sequence)
  48.  
  49.   State-space representation:
  50.   sl=syslin(dom,A,B,C [,D [,x0]     ])
  51.   represents the system :
  52.         s x  = A*x + B*u
  53.           y  = C*x + D*u
  54.         x(0) = x0
  55.   The output of syslin is a list of the following form:
  56.  
  57.   sl=list('lss',A,B,C,D,x0,dom)
  58.  
  59.   Note that D is allowed to be a polynomial matrix (improper systems).
  60.  
  61.   Transfer matrix representation:
  62.   sl=syslin(dom,N,D)
  63.   sl=syslin(dom,H)
  64.   The output of syslin is a list of the following form : sl=list('r',N,D,dom)
  65.   or sl=list('r',H(2),H(3),dom).
  66.  
  67.   Linear systems defined as syslin can be manipulated as usual matrices (con-
  68.   catenation, extraction, transpose, multiplication, etc) both in state-space
  69.   or transfer representation.
  70.  
  71.   Most of state-space control functions receive a syslin list as input
  72.   instead of the four matrices defining the system.
  73.  
  74. EXAMPLES
  75.   A=[0,1;0,0];B=[1;1];C=[1,1];
  76.   S1=syslin('c',A,B,C)
  77.   s=poly(0,'s');
  78.   D=s;
  79.   S2=syslin('c',A,B,C,D)
  80.   H1=(1+2*s)/s^2, S1bis=syslin('c',H1)
  81.   H2=(1+2*s+s^3)/s^2, S2bis=syslin('c',H2)
  82.   S1+S2
  83.   [S1,S2]
  84.   ss2tf(S1)-S1bis
  85.   S1bis+S2bis
  86.   S1*S2bis
  87.   size(S1)
  88.  
  89. SEE ALSO
  90.   ssrand, ss2tf, tf2ss, dscr
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.